home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / novell / faxdoc / 155.lit < prev    next >
Text File  |  1996-07-10  |  24KB  |  374 lines

  1.                             FYI
  2.  
  3. (Note:  The origin of this information may be internal or external to Novell.  Novell makes every effort within its means to verify this information.  However, the information provided in this document is FOR YOUR INFORMATION ONLY.  Novell makes no explicit or implied claims to the validity of this information.)
  4.  
  5.           TITLE:   NLCache
  6.    DOCUMENT ID#:   FYI.P.6121
  7.            DATE:   28Jan93
  8.         PRODUCT:   NetWare Lite
  9. PRODUCT VERSION:   All versions
  10.      SUPERSEDES:   FYI.P.6075
  11.  
  12.         SYMPTOM:   NA
  13.  
  14. ISSUE/PROBLEM
  15. NLCache
  16.  
  17. NETWARE LITE CACHING BENEFITS
  18. NetWare Lite Cache makes your computer run 3 to 6 times faster by reducing the time your computer spends waiting for the hard disk.  Caching makes your computer run faster and your hard drive last longer.
  19.  
  20.  
  21. WARNING
  22. NetWare Lite Cache should not be used concurrently with another caching software.  If you choose to use a different cache program instead of NLCache you must disable the cache's delayed writes, in NLCINST under Deferred write delay, together they may cause problems.
  23.  
  24. HOW NETWARE LITE CACHE WORKS
  25. NetWare Lite Cache keeps copies of data read from the disk in a memory area called a cache.  When a disk read is requested, NetWare Lite Cache checks to see if the data is already in the cache.  If it is, NetWare Lite Cache delivers the data directly from the cache; if not, the disk read is performed and a copy of the data is put in the cache.
  26.  
  27. NetWare Lite Cache's LookAhead option adjusts the disk transfers to cache data even before you need it, by reading entire blocks of sectors for future use.  LookAhead makes big improvements in disk throughput even with a small cache.  When disk writes are requested, NetWare Lite Cache determines if the data is in the cache and if it has actually changed.  If it hasn't changed,
  28. (determined by checksum) NetWare Lite Cache doesn't rewrite data to the disk.
  29.  
  30. NetWare Lite Cache's optional delayed write feature speeds up disk operations even more by combining multiple disk writes into a single write.  Also, NetWare Lite Cache can turn off the delayed write feature (in NLCINST) and function as a write-through cache.
  31.  
  32. If you have a power failure or reset the machine when using the delayed write feature, you may lose data because the data written to the cache in RAM is not written to the hard disk or floppy disk until the delayed write is complete.  When using delayed write, always exit programs correctly.
  33.  
  34.  
  35. The NetWare Lite NLCINST program helps you select the correct cache program for the type of memory your computer uses.
  36.   
  37.  
  38.      NLCACHEC    is for computers with only conventional memory                     (memory up to 640 KB). 
  39.  
  40.      NLCACHEX    is for computers with extended memory (memory                      above conventional, starting above 1024 KB). 
  41.  
  42.      NLCACHEM    is for computers with expanded memory (special or                  paged memory which requires a device driver). 
  43.  
  44. You can use only one disk caching program at a time.  If your computer has both expanded memory and extended memory, use either NLCACHEX or NLCACHEM. 
  45.  
  46. INSTALLING NETWARE LITE CACHE
  47. The NetWare Lite Cache programs are copied to your hard drive when you initially install NetWare Lite.  If you specify that you want to use the NetWare Lite cache during installation, the proper command will be automatically added to the STARTNET.BAT file--the file which loads the network into memory.
  48.  
  49. The INSTALL program recognizes the type of memory (conventional, expanded, extended) your computer has and how much memory is available.  If your computer has 1 MB or more of free memory, the INSTALL program defaults the "Use NLCACHE and load it from STARTNET.BAT" option to YES. (This option is under STEP 2 "Preview changes to DOS startup files" ).  If you want a cache, leave the option set to yes.  A NetWare Lite Startup command line, which includes the applicable NetWare Lite Cache program name (NLCACHEC, NLCACHEX, or NLCACHEM) and a number equal to half of the free memory (for the cache), will be included in STARTNET.BAT.  When STARTNET.BAT is run, the cache program loads using half of the free memory for the cache area.  If you do not want a cache, change the option to no. 
  50.  
  51. To create or modify the cache startup command line from the DOS prompt, type "NLCINST."  The current cache startup command line (if any) will be displayed.  Follow the instructions on the screen.  You can stop modifying or creating the cache startup command line at any time by pressing <Esc> repeatedly until the DOS prompt appears.  The new startup selections will take effect the next time you boot your computer.
  52.  
  53. INSTALLING AS A TSR
  54. If you put the cache startup command in batch file like AUTOEXEC.BAT or STARTNET.BAT, or manually type it at the DOS prompt, NetWare Lite Cache will be loaded as a TSR.  When NetWare Lite Cache is loaded as a TSR it can be unloaded by using the /Q option.  If you put the cache startup command in CONFIG.SYS, NetWare Lite Cache is loaded as a device driver and cannot be unloaded with the /Q option.   
  55.  
  56. INSTALLING AS A DEVICE DRIVER
  57. You must use DOS 3.0 or higher to load the cache as a device driver.  NetWare Lite Cache requires slightly less memory when it is loaded as a device driver than when it is loaded as a TSR.  (DOS assigns TSRs a copy of the environment and a 128 byte control block.  Device drivers do not have a copy of the environment or the 128 byte control block).  
  58.  
  59. Start NetWare Lite Cache as a device driver by putting one of the following commands in your CONFIG.SYS file:
  60.  
  61.  
  62. KEY TERMS 
  63.      [path]
  64.     Directory where the NetWare Lite Cache programs are located.
  65.  
  66.      [size]
  67.     Amount of memory (specify kilobytes) you want to allocate to
  68.     the cache.  If you don't specify a value, NetWare Lite Cache       uses all free memory for the cache. 
  69.  
  70.      [start]
  71.     Starting address in extended memory for the cache. Extended        memory addresses begin above 1024KB.  If you don't specify a       starting address, NetWare Lite Cache uses the first                available memory area.  This is the best choice for most           installations it allows NetWare Lite Cache to put the              control tables into extended memory.  However, you may             specify a specific address for NetWare Cache to use.
  72.  
  73.      [options]
  74.     One or more startup command options.  See the "Cache Startup       Commands" section of this document.  If you put the cache          startup command in your CONFIG.SYS file, NetWare Lite Cache        loads as a device driver each time you boot your computer. 
  75.     (remember, as a device driver it can not be unloaded with          the /Q option)
  76.     All other control options work as described in the "Netware        Lite Cache Control" section of this document.  To Manually         Create or Modify the Cache Startup Command as a TSR start          NetWare Lite Cache program by entering the cache startup           command line at the DOS prompt or by including it in either        AUTOEXEC.BAT or STARTNET.BAT.
  77.  
  78. TYPE OF          DEVICE DRIVER CACHE STARTUP COMMAND
  79. MEMORY
  80.  
  81. Conventional     Format:   DEVICE=[path] NLCACHEC.EXE [size]                        [options]
  82.                 Example:  DEVICE=C:\NWLITE\NLCACHEC.EXE 128 /T=2
  83.                 (The cache size would be 128 KB and the maximum                    write delay would be 2 seconds.)
  84.  
  85. Extended         Format:  DEVICE=[path] NLCACHEX.EXE [size]                         [start] [options]
  86.                 Example: DEVICE=C:\NWLITE\NLCACHEX.EXE 2048 D000                   /T=5 (The cache size would be 2048 KB, the                         starting address would be D000, and the maximum                    write delay would be 5 seconds.)
  87.  
  88. Expanded         Format:  DEVICE=[path] NLCACHEM.EXE                                [size][options]
  89.                 Example: DEVICE=C:\NWLITE\NLCACHEM.EXE 512                         /T=5/B=16
  90.                 (The cache size would be 512 KB, the maximum                       write delay would    be 5 seconds, and the                            LookAhead buffer size would be 16 KB.)
  91.  
  92.  
  93.   
  94.                 
  95.  
  96. TYPE OF          TSR CACHE STARTUP COMMAND LINE
  97. MEMORY
  98.  
  99. Conventional     Format:   NLCACHEC [size] [options]
  100.                 Example:  NLCACHEC 128 /T=5
  101.                 (The cache size would be 128 KB and the maximum                    write delay would be 5 seconds.)
  102.  
  103. Extended         Format:   NLCACHEX [size] [start] [options]
  104.                 Example:  NLCACHEX 1024 D000 /T=2
  105.                 (The cache size would be 1024 KB, the starting                     address would be D000, and the maximum write                       delay would be 2 seconds.)
  106.  
  107. Expanded         Format:   NLCACHEM [size] [options]
  108.                 Example:  NLCACHEM 512 /T=2
  109.                 (The cache size would be 512 KB and the maximum                    write delay would be turned off so the cache                       becomes a write-through cache.)
  110.  
  111. CACHE STARTUP COMMANDS
  112.   /A= Sector Chain Limit
  113.  
  114.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  115.  
  116.     Suppresses caching of read/write requests larger than the          limit value.  The limit value range is from 1 to 128 sectors       (128 sectors is the maximum number of sectors DOS allows).
  117.  
  118.     Use to tune the cache for unusual cases where programs are         effectively flushing your cache by doing large reads.  If          you select a sector limit value less than the maximum (128),       large reads are not cached.
  119.  
  120.     If this is not used, NetWare Lite Cache selects a best-fit         limit value.  For cache sizes smaller than 256 KB, a /A=           value larger than the best fit value is ignored.
  121.  
  122.  
  123.   /B= LookAhead Buffer Size
  124.  
  125.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  126.  
  127.     The size of the LookAhead buffer (specify kilobytes).  The         LookAhead buffer requires that you allocate additional             conventional memory to the size of the LookAhead buffer.
  128.     The LookAhead Buffer is used during sequential disk accesses       to improve computer performance.  NetWare Lite Cache               continually monitors your disk activity and turns LookAhead        on and off according to the type of reads being done.  When        you are performing sequential reads, NetWare Lite Cache            reads large blocks of sectors into the LookAhead buffer.           This saves time by anticipating future reads and combining         them with reads that have already been requested.
  129.  
  130.     The LookAhead buffer size can be from 0 to 16 KB.  Consider        a LookAhead buffer size of at least 9 KB.  If you specify a        LookAhead buffer of 0, both LookAhead buffer size (/B) and         the deferred write capability (/T) are disabled.
  131.  
  132.   /O   Control Table Location
  133.  
  134.      Use with NLCACHEX and NLCACHEM.
  135.  
  136.     Directs NetWare Lite Cache to use cache memory instead of          conventional memory for the cache control tables.  This            means that more of your conventional memory is available for       other applications.
  137.  
  138.     The /O option is suppressed if either the HMA (High Memory         Area) beginning at address 1024 KB is not available or if          the /R options used.
  139.  
  140.     The /O option may reduce cache performance (speed) when used       with abnormally slow add-on memory boards.
  141.  
  142.  
  143.  
  144.   /P   Place LookAhead in Expanded Memory
  145.  
  146.      Use with NLCACHEM.
  147.  
  148.     Uses expanded memory (instead of conventional memory) for          the LookAhead buffer.
  149.  
  150.     The /P option may reduce cache performance (speed) when used       with abnormally slow add-on memory boards.
  151.  
  152.  
  153.   /R   Disable A20 Latch
  154.  
  155.      Use with NLCACHEX.
  156.  
  157.     Disables the use of CPU latch A20.  Use this option ONLY if        you have compatibility problems or if your computer hangs          for no apparent reason.
  158.  
  159.     The /R option may be selected automatically in some computer       configurations.
  160.  
  161.   /S   Assign Cache High
  162.  
  163.      Use with NLCACHEX.
  164.  
  165.     Places the cache memory at the top of the extended memory.         This may be necessary if you are using programs which              reallocate extended memory, such as Windows/386, AutoCAD,          and Lotus 123 - release 3.  If you use this option, NetWare        Lite Cache ignores any starting address specification.
  166.  
  167.  
  168.   /T=  Maximum Write Delay
  169.  
  170.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  171.  
  172.     Specifies the maximum delay value for deferred disk writes.        The delay value may be from 0 to 5 seconds.  Write delay is        disabled if you enter a delay value of 0 (/T=0) or if the          LookAhead buffer is set to 0 (/B=0).  If the maximum write         delay value is 0 or if the LookAhead buffer value is 0,            NetWare Lite Cache operates as a write-through cache.
  173.     The deferred write feature speeds up your computer in two          ways:
  174.  
  175. 1)    It groups multiple small-write requests into fewer large-write requests.
  176.  
  177. 2)    It avoids repetitive writes to the same sectors.  DOS spends a lot of time writing and rewriting the same File Attribute Table (FAT) sectors on your disk.  When deferred writes are pending and a new write request is made for the same sectors, the new write data replaces older data so the physical write is performed once, with the most recent changes.
  178.  
  179.   /U   Non-conforming Partition
  180.  
  181.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  182.  
  183.     Certain schemes for partitioning hard disks larger than 33         MB don't handle the disk BIOS interrupts correctly.  If the        disk BIOS interrupts are handled incorrectly, use the /U           option. 
  184.           
  185.     The /U option is not required for normal DOS disk                  partitions. If this option is used, only the first 256 MB of       each physical disk is cached.
  186.  
  187.   /V   Disable INT 19 Capture
  188.  
  189.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  190.  
  191.     Disables normal INT 19 capture.  It may solve problems with        rare and unusual programs that use INT 19 in a non-standard        manner.
  192.  
  193.  
  194.  
  195.   /W   Disable Duplicate Write Check
  196.  
  197.      Use with NLCACHEX and NLCACHEM.
  198.  
  199.     Suppresses duplicate write-checking that NetWare Lite Cache        normally uses to avoid rewriting cached sectors that have          not changed.  The checking logic may produce false compares        when used with abnormally slow add-on memory boards.  If           your computer stops when the cache is started, try using           this option.
  200.  
  201.   /X   Disable Memory Diagnostic
  202.  
  203.      Use with NLCACHEX and NLCACHEM.
  204.  
  205.     When you start NetWare Lite Cache, it normally performs a          brief memory diagnostic check.  If you use this option, the        memory check is skipped.
  206.  
  207.   /Y   Enable 8088/86 High Memory Transfers
  208.  
  209.      Use with NLCACHEC and NLCACHEM.
  210.     Enables the caching of disk transfers to or from memory            addresses above B000:0000 on 8088/8086 computers.  If this         option is not used when NLCACHEC is running, transfers are         not cached due to the potential hardware DMA (Direct Memory        Access) channel unreliability.
  211.  
  212.   /Z   Disable Snooze Alarm
  213.  
  214.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  215.  
  216.     Disables NetWare Lite Cache's snooze alarm.  The snooze            alarm generates a low-pitched beep if NetWare Lite Cache is        unable to find a safe time slot to complete a deferred             write.  The alarm sounds every 5 seconds until pending             deferred writes are completed.
  217.  
  218. NETWARE LITE CACHE CONTROL 
  219. After NetWare Lite Cache is started, you can control its operation by executing a cache control command.  The control command consists of the name of the caching program and a control option.  For example, if you use NLCACHEX and want to get help on NetWare Lite Cache options, type:
  220.  
  221. NLCACHEX /HELP <Enter>
  222.  
  223.  
  224. Cache Control Commands
  225.   /HELP
  226.  
  227.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  228.  
  229.     Displays parameters and options that can be used in the            cache startup command line and lists the cache control             commands. 
  230.  
  231.   /Q   Quit
  232.  
  233.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  234.  
  235.     If NetWare Lite Cache was started as a TSR from the DOS            prompt or  batch file, this option terminates the NetWare          Lite Cache program and attempts to release all memory it was       using.  If other TSR programs were loaded after NetWare Lite       Cache, NetWare Lite Cache's conventional memory may be             locked.  If this happens, you may be able to quit NetWare          Lite Cache by unloading the TSR programs that were loaded          after NetWare Lite Cache and trying the /Q command again.
  236.  
  237.     If NetWare Lite Cache was started from your CONFIG.SYS file        as a device driver, this option has no effect.  Device             drivers can't be removed from memory.  The only way to take        a device driver out of memory is to remove its "device="           statement from your CONFIG.SYS file and reboot your                computer.
  238.  
  239.  
  240.   -    Disable & Flush
  241.  
  242.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  243.  
  244.     Flushes the cache buffers and disables the cache.  When the        cache is disabled, hard disk reads and writes are performed        as if the cache was never loaded.  The cache remains in            memory and can be enabled with the "+" option.
  245.  
  246.   +    Enable & Flush
  247.  
  248.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  249.  
  250.     Flushes the cache buffers, resets the cache statistics to 0,       and enables the cache if it was previously disabled with the       "-"option.
  251.  
  252.  
  253.   ?    Status
  254.  
  255.      Use with NLCACHEC, NLCACHEX, and NLCACHEM.
  256.  
  257.     Displays cache status. The top portion of the status screen        displays:
  258.  
  259.     1)   Cache size
  260.     2)   Drives being cached
  261.     3)   Current cache options
  262.  
  263.     In some cases, NetWare Lite Cache may selectively enable           certain options, even though these options were not                specified on the cache startup command. If the cache has           been disabled with the "-" option, the screen displays             "cache is inactive."  If "cache is inactive" is followed by        an error code, a serious problem exists. An error code 99          indicates that some other program is writing into NetWare          Lite Cache's control tables. Any other error code indicates        a problem with your add-on memory.
  264.  
  265. The Disk Usage Statistics show:
  266.  
  267.     1)   Number of read requests that DOS made
  268.     2)   Number of physical disk reads that were performed
  269.     3)   Percentage of reads saved because the data was in the              cache
  270.     4)   Number of write requests that DOS made
  271.     5)   Number of physical disk writes actually performed
  272.     6)   Percentage of disk writes saved because they were                  duplicated writes or the data had not changed
  273.  
  274. The Error Statistics show:
  275.  
  276.     1)   Number of cache memory errors
  277.     2)   Number of disk transfer errors
  278.     3)   Number of errors ignored by the user
  279.  
  280. Memory Errors are tallied whenever an error is detected in your extended or expanded memory subsystem.
  281.  
  282. Disk errors are tallied whenever an error is reported by your disk drive subsystem.
  283. Errors ignored by users are tallied when a disk error is detected while performing a deferred write and a user enters an ignore response at the "Retry or Ignore" prompt.
  284.  
  285.  
  286. MEMORY REQUIREMENT
  287. The resident conventional memory size required by NetWare Lite Cache is the
  288. total of the following:
  289.  
  290.  
  291.                     NLCACHEC       NLCACHEX       NLCACHEM
  292.                            
  293. Cache Program Size        8 KB           8 KB           8 KB
  294.  
  295. LookAhead Buffer Size    See /B        See /B        Note 1 Below
  296.  
  297. Cache Size            The amount   NOT           NOT
  298.                     memory you   APPLICABLE       APPLICABLE
  299.                     allocate to
  300.                     the cache                             
  301. Resident Control Table
  302. Size                    NOT           Note 2 & 3     Note 2 & 3                      APPLICABLE   Below          Below
  303.      
  304.      
  305.      
  306.      Note 1:    LookAhead buffer size may be controlled with the                   /B= option.If the /P option is active (see "Cache                  Startup Commands"), the LookAhead buffer is placed                 in the EMS memory.  No resident conventional                       (base) memory is required for the LookAhead                        Buffer.
  307.  
  308.  
  309.      Note 2:    If the /O option is active, cache sizes up to 5.3                  MB require no resident control table memory.  If                   your cache size exceeds 5.3 MB, multiply the cache                 size in megabytes by 4 to get the resident control                 table size in kilobytes.
  310.  
  311.      Note 3:    If the /O option is not active, the resident                       control table requires 12 KB for each megabyte of                  cache memory.
  312.  
  313. COMPATIBILITY
  314. NetWare Lite Cache is fully compatible with the XMS protocol, DOS network protocols, DesqView, Windows 3.1, and earlier Windows versions, and it operates with PC, XT, AT, and PS/2 compatible computers under MS-DOS and PC-DOS versions 2 through 5, DR DOS 6.0, and Windows 3.0 and 3.1. 
  315.  
  316. If you use a "Load High" memory manager such as 386MAX or QEMM, you may load the cache high.  Although this can be done, it may seriously impair cache performance when used with abnormally slow add-on memory boards.
  317.  
  318. ERROR MESSAGES
  319.  
  320. General Start-up Errors
  321. Already loaded -- NetWare Lite Cache is already loaded.
  322.  
  323. Amount not numeric -- Invalid size value specified.
  324.  
  325. Data Compare Error at location hhhhh -- hhhhh is a hexadecimal memory address. An error was detected during the memory diagnostic.
  326.  
  327. Invalid command line option -- Improper command line option specified.
  328.  
  329. No compatible fixed disk! -- No compatible disk found.
  330.  
  331. No Extended Memory available -- Either your computer has no extended memory installed, or another process is using all the extended memory.
  332.  
  333. A different NLCache is running -- A different version of NetWare Lite Cache caching program is already installed.
  334.  
  335. Too many drive letter options! -- You are attempting to cache more drives than allowed.
  336.  
  337.  
  338. Unsupported sector size! -- NetWare Lite Cache supports only sector between 512 and 16384 bytes.
  339.  
  340. NLCACHEX Specific Start-up Errors
  341. Insufficient Extended Memory -- There is not enough extended memory available to start the   cache.
  342. HMA is not available -- The High Memory Area at location 1024 is in use by another program.  The cache control tables will be located in resident conventional (base) memory.
  343.  
  344.  
  345. XMS Error Code\ xx -- xx is an error code returned by the extended memory manager.  This indicates a serious malfunction in the XMS manager.
  346. The most common error codes are:
  347.  
  348.     80 -- function not implemented
  349.     81 -- a VDISK device was detected
  350.     82 -- an A20 error occurred
  351.     8e -- a general driver error occurred
  352.     8f -- unrecoverable driver error occurred
  353.     A0 -- all extended memory is allocated
  354.     A1 -- all extended memory handles used
  355.     A2 -- invalid handle
  356.     A9 -- a parity error occurred
  357.  
  358. NLCACHEM Specific Startup Errors
  359. Expanded Memory content does not match data as written -- An error was detected during the cache start-up memory diagnostics.  You may have a hardware malfunction.
  360.  
  361. Insufficient Expanded Memory free -- All expanded memory is in use by other programs.
  362.  
  363. No Expanded Memory Manager -- Install the expanded memory manager software you received with your computer or with your expanded memory board.
  364.  
  365. Status Errors
  366. Cache is inactive: Error 99 at (location) -- The cache tables have been overwritten by another program that is accessing memory outside of its allocated region.  This condition may be caused by a faulty TSR (Terminate and Stay Resident) program or by a normal program addressing
  367. memory out-of-bounds.  You can identify the offender by removing programs one at a time until the problem goes away.
  368.  
  369. Cache is inactive:  Error xx -- xx is the error code given by the EMM or LIM driver. If NLCACHEM is unable to save the EMS page map due to repeated errors from the EMS driver, the cache shuts down.  There may be a serious problem with the EMS board or the EMM driver software.
  370.  
  371. Errors When Quitting
  372. Cannot release resident memory -- Other programs are loaded above NetWare Lite Cache.  You must unload these programs before quitting the cache.
  373.  
  374. Cannot remove device driver -- NLCache was loaded as a device that cannot be unloaded with the /Q opti